home *** CD-ROM | disk | FTP | other *** search
/ Informática Multimedia 1995 April / Informatica Multimedia CD - Epimundo.iso / DOS / CAT_DISK / PMCPL571 / PMCATPL.DOC < prev    next >
Encoding:
Text File  |  1992-03-15  |  46.8 KB  |  1,261 lines

  1.  
  2.  
  3.  
  4.                                 PM-Cat Plus
  5.  
  6.  
  7.  
  8.                       A Disk File Cataloging Program
  9.  
  10.                                     by
  11.  
  12.                            MegaSoft SoftWare(tm)
  13.  
  14.                                      &
  15.  
  16.                              William C. Scott
  17.  
  18.                         Portions by Patrick Michaud
  19.                             
  20.                               29 January 1992
  21.  
  22.  
  23.  
  24.  
  25.                                             _______
  26.                                        ____|__     |               (tm)
  27.                                     --|       |    |-------------------
  28.                                       |   ____|__  |  Association of
  29.                                       |  |       |_|  Shareware
  30.                                       |__|   o   |    Professionals
  31.                                     -----|   |   |---------------------
  32.                                          |___|___|    MEMBER
  33.  
  34.                       Copyright 1992 by William C. Scott
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.                                                                   Page 2
  72.  
  73.                   About Our Marketing Process ... (Shareware)
  74.  
  75.           The term "shareware" has come to refer to a class of computer
  76.           software that is marketed, basically, on an honor system.
  77.  
  78.           Hopefully you noticed the logo of ASP, the Association of
  79.           Shareware Professionals, on the cover sheet of this
  80.           documentation file.  <ASP> is an organization that was formed
  81.           and is supported by software authors and businesses with an
  82.           interest in seeing shareware remain a viable means of
  83.           marketing high quality software at reasonable prices.
  84.  
  85.           An author's membership in ASP guarantees the end user at least
  86.           some protection from the vagaries of earlier and present
  87.           'public domain' software.  By becoming a member of ASP the
  88.           author has promised his/her intention to support the product
  89.           after licensing has taken place and already demonstrated to ASP
  90.           the product does in fact do what it is advertised to do and is
  91.           a fully functional piece of software (not crippled or
  92.           restricted).
  93.  
  94.           (See the file OMBUDSMAN.ASP for further info)
  95.  
  96.           The end user benefits by being able to actually try the
  97.           software before paying for it.  This ensures compatibility
  98.           both with the system it is intended for use upon and user.
  99.  
  100.           Both the author and the consumer benefit from the fact that
  101.           neither has had to bear the burden of the enormous cost of
  102.           adequate advertising.  The consumer benefits directly from the
  103.           lower cost of the software, the author somewhat more
  104.           indirectly in that he most likely would never have been able
  105.           to make the product widely available because of a lack of
  106.           capital.  In many cases you will find the support offered by
  107.           ASP authors more comprehensive than would ever be possible
  108.           from a large company.
  109.  
  110.           Finally, these ASP authors' products, like PmCat+, are not
  111.           public domain nor intended to be free.  They are offered in
  112.           good faith that they are as good as their commercial
  113.           counterparts and the authors do expect to be paid for their
  114.           efforts.
  115.  
  116.           Frankly, it is a difficult thing to offer one's work to others
  117.           with the understanding you will be compensated *only* when the
  118.           customer is convinced your product is worth purchasing.
  119.  
  120.           Please realize that PmCat+ didn't just "happen".  We have
  121.           spent a great deal of money for compilers, language tools and
  122.           hardware that is specifically dedicated to the development of
  123.           PmCat+.  This does not to even begin considering the many
  124.           hours of sitting at the keyboard, tearing out hair trying to
  125.           figure out why the obviously simple, isn't!  We must, at the
  126.           very least, recover our financial investment so that we can
  127.           continue to develop programs of this quality.
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.                                                                   Page 3
  138.  
  139.           Strictly speaking, if you do like and use PmCat+, we expect
  140.           you to license the program after a reasonable trial period
  141.           (about 30 - 45 days).  We also realize there are those to whom
  142.           the $20 license fee would be a burden.  For those persons,
  143.           please send what you can afford and you will be registered!
  144.               Obviously, whether or not you can afford to license PmCat+
  145.           is not a consideration we would be so bold as to decide.
  146.           We will trust that everyone is being honest with themselves
  147.           and us about that matter and will, to the best of our ability,
  148.           answer any questions by anyone who wishes to inquire.
  149.  
  150.           For $20.00 you will receive:
  151.             1.  A copy of the very latest version of PmCat PLUS on 360K
  152.                  DS/DD 5.25" floppy disk.
  153.             2.  A copy of PmDelDup, a utility for deleting duplicate or
  154.                  multiple entries of the same filename in a PmCat
  155.                  catalog and optionally removing them from disk.
  156.             3.  A copy of PmConvert which will convert older PmCat files
  157.                  to the new format used in release 5.2.
  158.             4.  A copy of PM-Label for making diskette labels and
  159.                  inserts.
  160.             5.  Access to the registered user conference on the Melange
  161.                  BBS with access to the latest (registered) version of
  162.                  PmCat PLUS
  163.             6.  Placement on our mailing list to be notified of future
  164.                  updates.
  165.  
  166.           PLEASE NOTE:
  167.  
  168.           We can provide PmCat+ on 3.5" inch double density or high
  169.           density disks as well.  There is an additional $2 charge for
  170.           the 720K and $4.00 for the 1.44M because of the higher cost of
  171.           the 3.5" media.
  172.  
  173.           When you wish to register PmCat+, please send check or Money
  174.           Order to the address below:
  175.  
  176.  
  177.                              MegaSoft SoftWare(tm)
  178.                                   522 NW 14th 
  179.                               Pendleton, OR 97801
  180.                               Msg: (503) 278-2079
  181.  
  182.           See the file PM-ORDER.FRM for an invoice type order form.
  183.  
  184.           Support can be obtained by contacting us in the following ways:
  185.  
  186.                 A Message on The Melange BBS :    (405) 927-2541
  187.                             (USR HST14.4 24hrs)
  188.  
  189.                 Writing us at : MegaSoft SoftWare(tm)
  190.                                 522 NW 14th
  191.                                 Pendleton, OR. 97801  
  192.                             
  193.                 Leaving a message for : David Chamberlain at
  194.                                         (503) 276-6176
  195.                 This would be the best way as I can call right back!                     
  196.  
  197.                    
  198.  
  199.  
  200.  
  201.  
  202.  
  203.                                                                  Page 4
  204.  
  205.  
  206.  
  207.  
  208.  
  209.     COPYRIGHT NOTICE
  210.  
  211.           PmCat+, copyright 1987-92 by William C. Scott.  PmCat+ is NOT
  212.           public domain software.  You may use, copy and distribute it
  213.           freely, but you MAY NOT RESELL PmCat+.  A modest fee for
  214.           copying may be charged, not to exceed $3.00 exclusive of the
  215.           cost of disk, mailer and postage.  (See "About Our Marketing
  216.           Process" for more details)
  217.  
  218.  
  219.  
  220.  
  221.  
  222.     DISCLAIMER:
  223.  
  224.           By using this product, the user agrees that neither William C.
  225.           Scott nor MegaSoft SoftWare(tm) shall be held severly or
  226.           jointly liable for any damages, direct or consequential, that
  227.           might arise from the use, inability to use or misuse of PmCat+.
  228.  
  229.  
  230.     Warranty:
  231.  
  232.          The only warranty for PM-Cat Plus is that the distribuation
  233.          disk is free from defects in materials and workmanship. Should
  234.          the disk you receive be defective we will replace it at no cost
  235.          to you. Simply return the defective disk along with your address
  236.          to:
  237.                MegaSoft SoftWare(tm)
  238.                    522 NW 14th
  239.                Pendleton, OR.  97801
  240.  
  241.          Note: This warranty only applies to the disk we mail, we cannot
  242.                replace disk you receive from any of the authorized
  243.                distributors. Contact them for a replacement.   
  244.  
  245.  
  246.  
  247.            
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.                                                                 Page 5
  270.  
  271.  
  272.                            TABLE OF CONTENTS
  273.  
  274.         About Our Marketing - Shareware and ASP   ...............    2
  275.  
  276.         I.  Introduction   ......................................    6
  277.  
  278.        II.  Getting Started
  279.           A.  System requirements   .............................    7
  280.           B.  Features of PmCat+
  281.             1.  List of features   ..............................    7
  282.             2.  Explanation of features   .......................    8
  283.           C.  Installation   ....................................    9
  284.           D.  THINK about these things ..........................   10
  285.  
  286.       III.  Cataloging functions
  287.           A.  Create a new catalog   ............................   12
  288.           B.  Add to existing catalog   .........................   12
  289.           C.  Update an existing catalog   ......................   12
  290.           D.  Save present catalog   ............................   12
  291.  
  292.        IV.  Browse functions
  293.           A.  File information  (InfoWindow)   ..................   13
  294.           B.  Read contents of cataloged files    ...............   13
  295.           C.  Volumes listing   .................................   13
  296.           D.  Directories   .....................................   13
  297.           E.  Search   ..........................................   14
  298.           F.  Sort   ............................................   14
  299.           G.  Change catalogs   .................................   14
  300.           H.  Masks   ...........................................   14
  301.  
  302.         V.  Printing functions
  303.           A.  Formatting output   ...............................   14
  304.           B.  Printing   ........................................   16
  305.           C.  Printer set up string   ...........................   16
  306.           D.  Saving to ASCII disk file   .......................   16
  307.  
  308.        VI.  Misc functions
  309.           A.  Delete volume   ...................................   16
  310.           B.  Erase (delete) file   .............................   16
  311.           C.  Commenting   ......................................   17
  312.           D.  Shell   ...........................................   17
  313.           E.  Change volume label    ............................   17
  314.           F.  Using the .DEF file    ............................   17
  315.           G.  Using disk numbering   ............................   17
  316.           H.  Using categories   ................................   18
  317.           I.  Using Wildcards in PmCat+   .......................   19
  318.           J.  Soundex searches   ................................   19
  319.  
  320.       VII.  BBS Access  .........................................   20
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.                                                                 Page 6
  336.  
  337.     INTRODUCTION
  338.  
  339.                 PmCat+ is a floppy and hard disk file cataloging and
  340.             browsing program intended for use on PC/XT/AT and compatible
  341.             systems.
  342.  
  343.                 PmCat+ is a direct descendent of PmCat which was a disk
  344.             file cataloging program intended for use only with floppy
  345.             disk files.  So many users just naturally began using it to
  346.             catalog their hard drive files that many requests were made
  347.             for features that were obviously hard drive oriented. So, we
  348.             decided PmCat+ should accomodate hard drives gracefully.
  349.  
  350.                 The original PmCat was written by Patrick Michaud for Mr.
  351.             Scott's personal use.  Like so many others, He couldn't find a
  352.             cataloger that addressed his personal habits adequately
  353.             (simple, fast and useful were some of my prime requisites).
  354.  
  355.                 When Patrick first wrote PmCat, it was so good that he
  356.             and Mr. Scott decided to pat it on the rear and send it out
  357.             into the 'real world' as a shareware product ... "as an
  358.             experiment" just to see what happened.
  359.  
  360.                 Well, about three months later a phone call came to Mr.
  361.             Scott from Alfred Glossbrenner who was writing a book about PC
  362.             shareware products and wanted to include PmCat in his book ..
  363.             which did occur when it was published.  Mr. Scott's thoughts
  364.             at that point was ... "here's a professional in the PC world
  365.             who thinks highly enough of PmCat to choose it over all
  366.             those others...gee whiz!"  Both Patrick and Mr. Scott were
  367.             deeply flattered.
  368.  
  369.                 They soon realized their experiment had told then they had
  370.             something in PmCat.  So they set about making the necessary
  371.             improvements to make it palatable and useful to as many people
  372.             as possible.
  373.  
  374.                 As it turned out, Patrick's studies kept him from doing
  375.             much more with PmCat except correcting and cleaning up Mr.
  376.             Scott's early code as he learned to program in Turbo Pascal
  377.             in order to support PmCat.
  378.  
  379.                 Since late 1987, most of the changes made to PmCat have
  380.             been a result of Mr. Scott's meanderings through Turbo Pascal
  381.             and the PmCat code in response to users requests for changes
  382.             /fixes and improvements.
  383.  
  384.                 Now PM-Cat Plus has changed hands and is being handled
  385.             by MegaSoft SoftWare(tm) in Pendleton, Oregon. This change
  386.             was based on the need for features and support that Mr.
  387.             Scott could no longer give to the product.
  388.  
  389.                 MegaSoft SoftWare(tm) is dedicated to providing high
  390.             quailty software at a resonable cost. We will support PMCat+
  391.             to the best of our abilities and provide the end users with
  392.             those features they request ( If possible ). We are looking
  393.             forward to the feedback and support of our users and thank
  394.             you for making PMCat Plus what it is today!
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.                                                                 Page 7
  402.  
  403.  
  404.         Minimum System Requirements:
  405.  
  406.             IBM PC/XT/AT or compatible, 384K RAM, one floppy disk
  407.             drive.  Hard drives and subdirectories are supported.
  408.  
  409.         Suggested extra system features:
  410.  
  411.             More Memory! - PmCat+ *will* run in only 384K but 512K or
  412.                            640K is strongly recommended.
  413.  
  414.             Color monitor - either CGA, EGA or VGA makes fuller use of
  415.                             the different menu options easier.
  416.  
  417.             Mouse - these rodents are down in price to about $30 on
  418.                     the bottom line of pricing and make a lazy man's
  419.                     use of a computer much more palatable.
  420.  
  421.             Disk caching - these programs are fairly common and many are
  422.                            either public domain or shareware. This can
  423.                            speed up PmCat+ because of its use of
  424.                            overlays.
  425.  
  426.  
  427.         FEATURES
  428.              * Use categories to group your files
  429.              * Use numbering of disks through volume labels or a separate
  430.                 disk number ... or both!
  431.              * Catalog contents of archived files
  432.              * View files, archived or not while in PmCat+!
  433.              * Context sensitive help
  434.              * Mouse support
  435.              * Include and/or exclude files (read/view/print)
  436.              * Delete individual files from catalog and Now Disk!
  437.              * Delete volumes from catalog 
  438.              * Find Free Space on cataloged diskettes
  439.              * Assign a DRIVE:\PATHNAME to be a VOLUME
  440.              * Read subdirectories and labels, too
  441.              * Comment each file with up to 80 characters
  442.              * "Rubber-stamp" for comments for duplicate files
  443.              * Sort catalog by filename, ext, size, path or date
  444.              * Supports WILDCARD ("*" and "?") searches of files
  445.                and comments
  446.              * User configurable printer formatting
  447.              * Automatic update of catalog when disks are reread
  448.              * User customizing of color, catalog name, ASCII filename
  449.              * Relabel diskette if desired
  450.              * Create ASCII disk file with user-assigned name
  451.              * Multiple catalogs with your specified names
  452.              * Erase an entire disk
  453.              * Coming Soon...... The support of Expanded/Extended or
  454.                virtual memory.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.                                                                 Page 8
  468.  
  469.  
  470.  
  471.         Explanation of features:
  472.  
  473.                 The detailed explanation of each menu function is listed
  474.                 in the later part of the manual.  This portion explains
  475.                 the general use of the keyboard and/or mouse to access
  476.                 those options. NOTE: Some features are listed in the
  477.                 file CHANGES.DOC included with this disk. They will be
  478.                 incorparated into these documents when we re-write them!
  479.  
  480.                 The HELP function is toggled ON/OFF by pressing the 'H'
  481.                 key on the keyboard or the right AND left buttons of the
  482.                 mouse at the same time or <F1>. This function does not
  483.                 toggle in the shareware distribution copy.
  484.  
  485.                 Each menu can be accessed through three functions, the
  486.                 HOT KEY, the MENU BAR or the mouse.
  487.  
  488.                 On each menu item, one letter is capitalized. Pressing
  489.                 that letter or character on the keyboard will select
  490.                 that menu item and cause it to be executed.
  491.  
  492.                 On each menu, one item is indicated at a time by the bar
  493.                 selector or MENU BAR.  The MENU BAR is moved using the
  494.                 RIGHT and LEFT keyboard arrow keys. When the bar is on a
  495.                 item, pressing <ENTER> on the keyboard will select that
  496.                 item and cause it to be executed.
  497.  
  498.                 Where appropriate the RT/LT, UP/DN arrows, PgUp/PgDn and
  499.                 Home and End keys are active for the screen instead of
  500.                 the menu area, as well as functions available to do the
  501.                 same things on the menu with the mouse.
  502.  
  503.                 The cursor within the menu area (which you will see if a
  504.                 mouse is present) is the mouse cursor.  Use your mouse
  505.                 to select an item by placing the cursor on the item name
  506.                 or within 1 space on either side and pressing the left
  507.                 mouse button.  If HELP is turned on, another click of
  508.                 the left button is necessary to execute the function.
  509.                 This was done to allow you to see what the operation
  510.                 does before you execute it.  When HELP is turned off,
  511.                 the second click is not necessary.
  512.  
  513.                 Pressing the RIGHT mouse button is the same as pressing
  514.                 the <ESC> key on the keyboard.
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.                                                                 Page 9
  534.  
  535.  
  536.  
  537.         The following items are essential only to the browsing and
  538.         archive extraction functions of PmCat+.
  539.  
  540.             The defaults installed in PmCat+ will look for the other
  541.             files it may require, in the current directory. (The
  542.             directory you are in when you run PmCat+).  The defaults
  543.             referred to involve the following programs and locations.
  544.  
  545.                 1. Text viewer/editor - PMLIST.COM 
  546.  
  547.                 2. ARC extractor - program for extracting the contents
  548.                                    of .ARC files. ARCE.COM is default.
  549.                 3. ZIP extractor - program for extracting the contents
  550.                                    of .ZIP files. PKZIP.EXE is default.
  551.                 4. ZOO extractor - program for extracting the contents
  552.                                    of .ZOO files. ZOO.EXE is default
  553.                 5. PAK extractor - program for extracting the contents
  554.                                    of .PAK files. PAK.EXE is default
  555.                 6. LZH extractor - program for extracting the contents
  556.                                    of .LZH files. LHARC.EXE is default.
  557.                 7. Scratch path -  a drive/directory path where the
  558.                                    files extracted from an archive will
  559.      (Choose carefully! .. the     be written while you view them. You
  560.       extracted file will be       cannot edit files from within an
  561.       deleted later..suggest a     archive and update the archive with
  562.       'SCRATCH' directory)         the changed file from PmCat+.
  563.                 8. Target drive - This is the drive on which PmCat+ will
  564.                                    try to find the file chosen, using
  565.                                    the pathname information stored in
  566.                                    the PmCat+ catalog. The default is
  567.                                    drive 'A'.
  568.  
  569.  
  570.  
  571.             NOTE: NO decompressing code is in the PmCat+ program.  It is
  572.                   assumed if you have files stored with a compression
  573.                   program, that program can be executed from the DOS
  574.                   command line and thereby used to extract files.
  575.                   PmCat+ just acts as a messenger between you and the
  576.                   archiving program by sending the filename to extract
  577.                   to the program you have said will extract it.
  578.  
  579.                 If you don't know how to configure your system using
  580.             PATH and don't want to deal with it (for whatever reason),
  581.             just place copies of the appropriate programs from the
  582.             above list in the same directory as your PmCat+ files and
  583.             catalog.
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.                                                                 Page 10
  600.  
  601.  
  602.         Things to consider BEFORE you start building your catalog:
  603.  
  604.                 The new features added to PmCat have made a great deal
  605.                 of flexibility in structuring your catalog possible.
  606.  
  607.                 These very same features will likely confuse you if you
  608.                 decide to use them without proper consideration.  They
  609.                 CAN be ignored and everything done as always with PmCat,
  610.                 but they are there if you want or need them.
  611.  
  612.                 The features most likely to offer confusion are the DISK
  613.                 number and CATEGORY function.
  614.  
  615.                 As of version 5.3, these are NOT written to the disk in
  616.                 any manner.  They are a form of notation to aid you in
  617.                 keeping track of things with your disk collection.
  618.  
  619.         CATEGORIES - these are assigned to the volume when you catalog
  620.                 it. All files on the volume will have the same category
  621.                 in your PmCat data file.  You may Edit the categories of
  622.                 Files or Volumes once cataloged by using the Edit
  623.                 function in PmCat.  Presently, if you update the volume,
  624.                 you will lose those Edited categories and the category
  625.                 will once again be whatever you assign to the volume.
  626.                 This will be fixed in a future release..but be aware it
  627.                 is a limitation of sorts just now.
  628.  
  629.                 Assigning a category - when you Update a volume, there
  630.                 is a menu choice of CATEGORY. Select this and pick one
  631.                 of the existing categories or use the Update key to
  632.                 create a new category.  DON'T FORGET to save the new
  633.                 definitions to your .DEF file if you use CATEGORIES
  634.                 other than the defaults!
  635.  
  636.         DISK NUMBERING - in the early stages of testing, this seemed to
  637.                 create the greatest confusion.  Actually, it is a rather
  638.                 easy and powerful feature once you understand what it
  639.                 does.
  640.  
  641.                 There are three modes for Disk Numbering, OFF, MANual,
  642.                 and AUTOmatic and these are reflected on the Update
  643.                 Screen window. They are changed by selecting Numbering
  644.                 from the menu and using the arrow keys to select the one
  645.                 you want.
  646.  
  647.                 If you select OFF, a number of '0' will be assigned as a
  648.                 placeholder in the data file and otherwise ignored.
  649.  
  650.                 If you select MANual, the number that is shown above the
  651.                 window as Disk # will be assigned to the disk when it is
  652.                 cataloged. You may assign a new or different number just
  653.                 by typing it in.
  654.  
  655.                 If you select AUTOmatic the number you set is
  656.                 automatically incremented each time a disk is cataloged.
  657.                 You may set the starting number in the same way as for
  658.                 MANual ... just type it in.
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.                                                                 Page 11
  666.  
  667.         There is also an option called Duplicate Disk Numbers Allowed
  668.                 which is a YES/NO choice.  It WILL NOT PREVENT
  669.                 duplicates, it merely checks for them as an aid to you.
  670.                 If this is set to YES, the option is essentially
  671.                 inactive... since YES indicates you want to allow
  672.                 duplicates.
  673.  
  674.                 OK, when YES and when NO?  Let's take, for example, a
  675.                 situation where you want to store your disks in strict
  676.                 numerical order (as many do).  Each disk has a small
  677.                 sticker or other marking indicating its numeric order
  678.                 in your catalog.  In such a case, every number is likely
  679.                 to be unique and you would NOT want to allow duplicate
  680.                 Disk Numbers.
  681.  
  682.                 Alternatively, perhaps you have your disks stored or
  683.                 referenced alphabetically by categories, such as GAMES,
  684.                 BASIC, etc.  In this case you can catalog your disks
  685.                 using CATEGORIES and AUTOmatic numbering with duplicate
  686.                 disk numbers allowed.  You might catalog 5 games disks,
  687.                 as GAMES 1 thru GAMES 5 and your BASIC disks in the same
  688.                 manner.  As the categories grow, it is a simple matter
  689.                 to add GAMES 6, GAMES 7 and so on to your library. PmCat
  690.                 will allow you to view only the GAMES category disks if
  691.                 you like by selecting the <L>imit option in the <V>iew
  692.                 window.  Just place the cursor on a file with the category
  693.                 you want to limit your viewing to, and press <L>.  The
  694.                 catalog will be searched an only the GAMES (?) will be
  695.                 displayed.  (If you print at this point, only the selected
  696.                 category will be printed, as well)
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.                                                                 Page 12
  732.  
  733.     CATALOGING FUNCTIONS
  734.  
  735.         CREATE A NEW CATALOG:  <R>ead, <W>rite  on MENU 1 and MENU 2
  736.  
  737.             Any time PmCat+ <R>eads a catalog from disk, you are shown
  738.              the current catalog name and prompted for a catalog name. If
  739.              you wish to use the catalog name shown, just press <ENTER>.
  740.              If using a mouse, place the mouse cursor on the ENTER menu
  741.              item and press the right button.
  742.  
  743.             To specify a name of your choosing just start typing it in
  744.              and press <ENTER> or press the left mouse button when
  745.              complete. A filename with wildcards is acceptable and will
  746.              place you in the 'pick list' with the appropriate files to
  747.              choose from.
  748.  
  749.             To select a catalog from the files on disk, select or type
  750.              the asterisk ('*') and press <ENTER>.  This will present
  751.              you with a 'pick list' from which to choose.
  752.  
  753.             This sequence of events first occurs when you run PmCat+. It
  754.              also happens each time you <R>ead from or <W>rite to the
  755.              disk.
  756.  
  757.  
  758.         ADD FILES/UPDATE CATALOG:    <U>pdate menu option  on MENU 1
  759.  
  760.             <U>pdate appears only on the first menu (MENU 1) you
  761.              encounter in PmCat+.  Choosing this option takes you to a
  762.              window where you may
  763.  
  764.                 1) Read files from a drive which you specify by pressing
  765.                    the appropriate letter on the keyboard or choosing it
  766.                    from the menu ... or
  767.  
  768.                 2) Change the volume label of a disk drive by using the
  769.                    '#' symbol on the menu or from the keyboard.
  770.  
  771.         SAVE CURRENT CATALOG TO DISK:  <W>rite  on MENU 1 or MENU 2
  772.  
  773.             <W>rite will save the current catalog to disk from
  774.              either MENU 1 or MENU 2.
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.                                                                 Page 13
  798.  
  799.  
  800.  
  801.  
  802.  
  803.     BROWSE FUNCTIONS:  <I>nfo, <V>olumes, <D>ir, <SPACE>  on MENU 2
  804.  
  805.     These are the functions you will use to find files and view their
  806.     statistics, comments and contents of the actual file if desired.
  807.  
  808.         <V> menu selection from MENU 2 will cause a list of volumes
  809.          contained within the current catalog to be displayed.  The
  810.          volumes may be sorted just as though they were filenames (which
  811.          really is what a DOS volume label is ... with the appropriate
  812.          attribute set).
  813.  
  814.         <D> on MENU 2 will show the list of files contained within that
  815.          directory-type object.  If it is a directory then the files are
  816.          shown. If it is a compressed file then the contents of the
  817.          archive are shown if you cataloged the disk with archive reading
  818.          turned on.
  819.  
  820.         <SPACE> - pressing the spacebar will allow you to view the
  821.          contents of the file that is currently being pointed to by the
  822.          selector bar in the window.  Check to make sure the file is
  823.          located on the drive indicated on the line just above the menu.
  824.          If it needs to be changed, just press the appropriate key to
  825.          select the right drive and then press <ENTER>.  What happens at
  826.          this point is partly dependent on which program you have chosen
  827.          to run (the text viewer/editor you specified or accepted in the
  828.          Set Defaults area).
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.                                                                 Page 14
  836.  
  837.  
  838.         SEARCH:  <F>ind, <N>ext   on MENU 2
  839.  
  840.         These functions are used to find files by filename, an entry in
  841.         the Comments field and they are also used to find free space on
  842.         a volume when the list of volumes is displayed. SEE NOTE ON PAGE
  843.         16 ABOUT SOUNDEX SEARCHES.
  844.  
  845.             <F>ind will first prompt you to select whether you wish to
  846.              search for a file based on filename, comments or free
  847.              space.  The free space choice is an invalid choice if a
  848.              list of volumes is not being displayed.
  849.  
  850.             <N>ext will find the next entry matching the search
  851.              criterion you provided for the <F>ind command.
  852.  
  853.  
  854.         SORT:  <S>ort    on MENU 2
  855.  
  856.             <S>ort can be selected only from MENU 2 while PmCat+ is
  857.              running.  However, turning autoSort ON while setting default
  858.              filenames and paths will cause a sort by filename when you
  859.              move from MENU 1 to MENU 2 to occur automatically.
  860.  
  861.             After selecting <S>ort from MENU 2, you will be prompted to
  862.              choose among filename, ext, size, date and path as the
  863.              options on which to sort.  Select one..
  864.  
  865.             Then you will be prompted for sort order - ascending or
  866.              descending.  Descending puts the largest value first which
  867.              would be appropriate for volume free space (that's the Size
  868.              of volumes) but not for alphabetically arranged data.
  869.  
  870.         CHANGE CATALOGS: <R>ead   on MENU 1
  871.  
  872.             This procedure is identical to the initial reading of a
  873.              catalog when you enter PmCat.  It first clears the memory
  874.              of the existing catalog and then prompts you for a new
  875.              catalog name which you may enter using the keyboard or pick
  876.              list function.
  877.  
  878.  
  879.         MASKS: <M>ask-set  on MENU 1a3    (arrow keys disabled in menu)
  880.  
  881.             The Mask function consists of two portions, Include and
  882.              Exclude and act as a filter.  It works on those files you
  883.              wish to View, Print or Catalog using PmCat+ when either of
  884.              its actions are turned ON.
  885.  
  886.             Include and Exclude may be toggled ON or OFF independently
  887.              of each other by selecting them from MENU 1a3.
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.                                                                 Page 15
  902.  
  903.  
  904.             If both are selected, Include takes precedence.  Remember,
  905.              if you turn both ON, NOTHING will be INCLUDED, except what
  906.              you specify and the same goes for EXCLUDE.  This can be
  907.              tricky until you get used to it.
  908.  
  909.             The menu (1a3) for changing the MASK functions is accessed
  910.              thru the <S>et defaults option of MENU 1.
  911.  
  912.             At MENU 1a3:
  913.                 Exclude - toggles the exclude list ON/OFF
  914.                 Include - toggles the include list ON/OFF
  915.                 Clear - clears the item pointed to by the bar cursor
  916.                 <ENTER> - allows you to input a new or change the old item.
  917.  
  918.  
  919.     PRINTING: <P>rint on MENU 1a4, <P>rint on MENU 2, <D>isk from print
  920.  
  921.         FORMATTING OUTPUT:   (arrow keys disabled in menu)
  922.  
  923.             <P>rint selected from MENU 1a4 opens a window to allow the
  924.              specification of format parameters for your printed catalog.
  925.  
  926.                 Start-col is the column of the printed page on which the
  927.                  field will begin.
  928.  
  929.                 Width is how many characters the field will occupy on
  930.                  the printed document.  This can be any width you wish,
  931.                  but if it is less than required for any field except
  932.                  comments, it will be truncated (chopped off).
  933.  
  934.                 Comments will print col the width you specify and repeat
  935.                  until on the next line until all actual comments for
  936.                  that file are printed.  Then it will begin printing the
  937.                  next entry.  Comments are left justified.
  938.  
  939.                 Filename is a 12 character field consisting of the
  940.                  filename, a period and the file extension.  It is right
  941.                  justified.
  942.  
  943.                 Size is a number that will occupy 10 spaces.  It is right
  944.                  justified.
  945.  
  946.                 Date will occupy 10 spaces, MM/DD/YY format.
  947.  
  948.                 Path can be up to 65 characters and is the path to the
  949.                  file on its particular volume.
  950.  
  951.                 Volume is the volume name from which the file was read.
  952.                  It may be up to 11 characters and is left justified.
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.                                                                 Page 16
  968.  
  969.  
  970.  
  971.         PRINTING:  <P>rint  on MENU 2
  972.  
  973.             PRINTER SET UP STRING: <*>  on Print window menu
  974.  
  975.                 <*> - will prompt you for a new string of characters
  976.                  which will be sent to your printer before printing of
  977.                  the catalog starts.  Each character must be in decimal
  978.                  form and preceded by a '#' and followed by a space.
  979.  
  980.                         e.g.,   #27 #15
  981.  
  982.                  Up to 20 characters may be used here.
  983.  
  984.             ASCII DISK FILE: <D>   on Print window menu
  985.  
  986.                 <D> - will cause the output which would normally go to
  987.                  your printer, to be sent to the disk as a file with the
  988.                  name you specify in ASCII format.  It can be easily
  989.                  edited and/or printed at a later time.
  990.  
  991.     MISC FUNCTIONS:
  992.  
  993.         DELETE VOLUME:
  994.  
  995.             <D> - chosen at MENU 1 will open a window with all the
  996.              volumes in your current catalog.  To delete a volume, use
  997.              the UP/DN arrow keys and select it with the bar and press
  998.              <ENTER>.  You will still be given an opportunity to abort
  999.              the operation at this point by answering Y/N on the menu.
  1000.              Obviously this operation is not final till you save the
  1001.              modified catalog to disk...but at that point, it is
  1002.              permanent.
  1003.  
  1004.         ERASE FILE:
  1005.  
  1006.             <K>ill a file from MENU 2.  It is the same process as
  1007.              deleting a volume from MENU 1.  The difference in the two
  1008.              operations is, when you Erase a file, the slot it occupied
  1009.              on the screen is shown >>DELETED<< instead of removed
  1010.              altogether.  As with volume deletion, the operation is not
  1011.              final until you save the modified catalog to disk.
  1012.  
  1013.  
  1014.  
  1015.  
  1016.  
  1017.  
  1018.  
  1019.  
  1020.  
  1021.  
  1022.  
  1023.  
  1024.  
  1025.  
  1026.  
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.                                                                 Page 17
  1034.  
  1035.  
  1036.         COMMENTING FILE:
  1037.  
  1038.             <C>omments may be added to files *and* volumes.  To comment
  1039.              a volume you just select the <V>olume list from MENU 2 and
  1040.              select <C> from the menu.  A small editor aids you in the
  1041.              input of your comments.  A 40x2 window accepts your
  1042.              comments.  The UP/DN arrow keys will move between the lines,
  1043.              the HOME/END keys are active and INSERT is the standard
  1044.              mode (there is NO overstrike mode).  DELETE works as well.
  1045.              PgUp/PgDn will accept your comments and immediately place
  1046.              you in the comments field of the preceding or succeeding
  1047.              file, ready to type more comments.
  1048.  
  1049.         OPERATING SYSTEM (Shell):
  1050.  
  1051.             <O> - from MENU 2 will execute a call to create a temporary
  1052.              shell in DOS so you can copy, delete, inspect and otherwise
  1053.              wreak havoc on your poor unsuspecting system.  If enough
  1054.              memory is not available, this feature will refuse to work.
  1055.  
  1056.         CHANGING VOLUME LABEL:
  1057.  
  1058.             <#> - chosen when in the <U>pdate section, will read the
  1059.              present disk label, tell you what it is and ask you if you
  1060.              wish to change it.  You MUST have a drive selected for this
  1061.              feature to function.
  1062.  
  1063.         USING THE .DEF FILE:
  1064.  
  1065.             This option, frankly can be tricky if you want a different name
  1066.              than PMCAT.DEF.  PmCat+ will *always* look for 'PMCAT.DEF'
  1067.              when it is run, if it isn't found the internal defaults are
  1068.              used.  The option of providing the alternative .DEF files was
  1069.              to cover the possibility that someone might want an
  1070.              alternative color set or other defaults on occasion.
  1071.              Frankly, I use PMCAT every day and never use this option, but
  1072.              it was an option that was so simple to offer and doesn't get
  1073.              in the way of anything else, that it was put in.
  1074.  
  1075.         USING DISK NUMBERING
  1076.  
  1077.             There are three aspects to using the disk numbering feature of
  1078.              PmCat PLUS.  First, what number to assign the disk and second,
  1079.              how to assign that number.  Finally, you decide whether to
  1080.              allow duplicate disk numbers or not.
  1081.  
  1082.             Also, the disk numbering feature is separate from the
  1083.              sequential numbering of the Volume Labels from within PmCat
  1084.              PLUS.  These numbers are part of the catalog record but are
  1085.              NOT written to the disk.
  1086.  
  1087.             When you catalog a disk with disk numbering active and have
  1088.              decided NOT to allow duplicates, PmCat PLUS will check for
  1089.              the existence of both that disk number and the volume label
  1090.              with which it is associated and issue a warning when it finds
  1091.              duplication of either.
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.                                                                 Page 18
  1100.  
  1101.             How To Number:
  1102.  
  1103.                 OFF - means ignore the function. A number of '0' is
  1104.                       assigned in this case.
  1105.  
  1106.                 MAN - manual entry of the number.  You do this by simply
  1107.                       beginning to type the number desired for the disk
  1108.                       immediately prior to cataloging that disk.  When
  1109.                       you make the first keystroke, a small text line
  1110.                       will appear on the screen one line above the menu.
  1111.                       If you wish to abort the process, just press <ESC>
  1112.                       and the old number will be left unchanged.
  1113.                       Remember, in this mode you MUST ENTER THE NUMBER
  1114.                       for it to be assigned.
  1115.  
  1116.                 AUT - in this mode, each time a disk is read, the number
  1117.                       that will be assigned to the next disk is
  1118.                       generated auto- matically by incrementing the
  1119.                       prior disk number by one. This feature may be
  1120.                       overridden by manual entry of the number as
  1121.                       described above, for any disk.  Upon entry to
  1122.                       PmCat PLUS, the number is set to zero, unless it
  1123.                       has been saved in the DEF file.
  1124.  
  1125.         USING CATEGORIES
  1126.  
  1127.             A category may be assigned at the same time the disk number
  1128.              above is assigned, though neither is dependent on the use
  1129.              of the other.
  1130.  
  1131.             The category list is accessed by choosing either <C>ategory
  1132.              from the Update window menu or <E>dit from the View window
  1133.              menu.
  1134.  
  1135.             In either case, to set a category for the item of interest,
  1136.              just place the cursor bar on the category you wish and
  1137.              press <ENTER>.  The list of CATEGORIES will automatically
  1138.              be sorted.  They will be saved to your .DEF file when you
  1139.              exit PmCat PLUS.
  1140.  
  1141.             If you wish to have different categories than those in the
  1142.              defaults, just select <U>pdate from the menu while viewing
  1143.              the category window and type in the new category.  A
  1144.              category name is limited to 10 characters.
  1145.  
  1146.             When a category is assigned to a volume before it is read,
  1147.              all files on that volume are assigned the same category by
  1148.              default.
  1149.  
  1150.             The category of any file or volume may be changed by
  1151.              choosing the <E>dit function in the View window menu.
  1152.  
  1153.             In order to limit your viewing or printing of files based on
  1154.              their category, just place the cursor on a file that has
  1155.              the category you want and select <L>imit from the View
  1156.              window menu.
  1157.  
  1158.  
  1159.  
  1160.  
  1161.  
  1162.  
  1163.  
  1164.  
  1165.                                                                 Page 19
  1166.  
  1167.  
  1168.  
  1169.         USING WILDCARDS:
  1170.  
  1171.             PmCat+'s wildcards are a bit more flexible than DOS's. E.g.,
  1172.              if you type *ca*.* with DOS's dir command, it will show ALL
  1173.              files.  It sees the first '*' and then looks for the '.'
  1174.              and extension wildcard.  If you used that same wildcard in
  1175.              PmCat+ it would find all files with 'ca' anywhere in their
  1176.              filename (not extension).
  1177.  
  1178.             When searching for a string in Comments, don't forget to
  1179.              precede it with a '*' unless you are certain the first
  1180.              character of the comments you want will match the first
  1181.              character of the string you search for.
  1182.  
  1183.             Where '*' assumes ALL characters match, '?' assumes the
  1184.              match of only a SINGLE character.
  1185.  
  1186.  
  1187.         SOUNDEX SEARCHES:
  1188.  
  1189.             When you chose the <F>ind option from MENU 2, you will see
  1190.              four options; filename, comments, size and soundex.  The
  1191.              soundex search functions only on filenames and from the
  1192.              first character.  With those limitations in mind, you can
  1193.              type in a key that simply 'sounds' like the one you want,
  1194.              and PmCat PLUS will locate that file for you.
  1195.  
  1196.             To find a string of characters within a string you must
  1197.              use the wildcards as described above.
  1198.  
  1199.             Soundex searches work in a very unique manner.  The first
  1200.              character (alphabetic) and a numeric code for the rest of
  1201.              the search string, which is generated by the Soundex routines
  1202.              based upon phonetic approximations, are combined into the
  1203.              patter which is searched for.  You will find it matches
  1204.              things you don't expect and doesn't on some things you
  1205.              expect.  A bit of experience in using it can make it a
  1206.              useful tool, however.
  1207.  
  1208.             Basically, type in the word you wish to find, or the closest
  1209.              spelling you can imagine.  The Soundex search may well
  1210.              surprise you with its effectiveness.
  1211.  
  1212.  
  1213.  
  1214.  
  1215.  
  1216.  
  1217.  
  1218.  
  1219.  
  1220.  
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.                                                                 Page 20
  1232.  
  1233.  
  1234.  
  1235.         PmCat PLUS and Melange BBS :
  1236.  
  1237.               Support and access is given to registered users on the
  1238.            Melange BBS ( Mr. Scott is changing the name at this time to
  1239.            a different name ) the number will remain the same for a bit.
  1240.            
  1241.  
  1242.             Once a registered user calls, he/she will be given access to
  1243.              the registered user conference and have access to the
  1244.              latest version of PmCat PLUS (registered).  So, if you plan
  1245.              to get the updates, it would be good planning to call and
  1246.              just leave a quick note to let me know you want to be given
  1247.              access.  I'll do so for you as quickly as possible.
  1248.  
  1249.             Even on your first call, you have unlimited download
  1250.              privileges, so don't hesitate to give a ring.
  1251.  
  1252.             All the files may not be commented, but PCBoard allows the
  1253.              user to look into and read files within archives...even
  1254.              download the docs of a program without getting the whole
  1255.              thing! ... and you *can* browse the contents of any
  1256.              archived file while on line.
  1257.  
  1258.             Registered PmCat users will have other benefits on the
  1259.              Melange BBS.  Unregistered users are more than welcome, but
  1260.              will come under 'normal' restrictions.
  1261.